home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / ucpck104.zip / UUCPCHK.DOC < prev    next >
Text File  |  1995-12-06  |  8KB  |  166 lines

  1. UUCPCHK.EXE Version 1.04 Copyright (c) 1995 by James J. Murphy
  2.  
  3. This program is Freeware.  If you have any suggestions, complaints,
  4. or bug reports, then I may be contacted via Internet E-Mail.
  5.  
  6. My address is: jim.murphy@4-920-100-0.sunshine.com
  7.    - or -      jmurphy@pananet.com
  8.  
  9. STANDARD DISCLAIMER
  10.  
  11. Run this program at your own risk.  My Fido Net here in the Republic
  12. of Panama is presently using this program to check UUCP addressed
  13. Internet E-Mail for people subscribing to LISTs or attempting to FTP,
  14. or download WWW pages.  I take no responsiblity for any damage done
  15. to your computer hardware, software, or message bases, by your use
  16. of this program.
  17.  
  18. WHAT THIS PROGRAM DOES
  19.  
  20. This program will check all messages in your Netmail (.MSG)
  21. directory addressed to UUCP (or an optional additional name),
  22. that do not have the HOLD or SENT flag set, against a list of BAD
  23. addresses, or address fragments (ftp, www, etc.).  If it finds any,
  24. it will set a flag in the message of either HOLD or SENT.  This
  25. stops the message from being sent and allows you to manually check
  26. the message, or you can use a utility like NETMGR to BOUNCE these
  27. messages back to the sender.  It also checks for the presence of an
  28. '@' symbol (or additionally, AND optionally a BANG '!' symbol) in
  29. the address, and if missing, flags the message as bad.  It checks
  30. for a comma ',' in the address (not allowed), and will flag that
  31. also.  If there is no address after the TO: line in the text of the
  32. message, or more than one space after the TO:, or no TO: at all,
  33. then it will also flag the message.
  34.  
  35. While running you will see the word 'Working' appear, and for each
  36. message processed you will see a Dash (-) appear.  If a message is
  37. found that has improper addressing you will see a Plus-Sign (+)
  38. appear, and if a possible corrupted message is found, then you will
  39. see an Asterisk (*) appear.  A report is then shown showing the
  40. total messages processed, and the number of BAD (Improperly
  41. Addressed) messages, and the number of corrupt messages.  If you
  42. have the LOG feature turned on then BAD and CORRUPT messages will be
  43. described in the log file.
  44.  
  45. Either put the contents of the archive in its own directory, or put
  46. it into the same directory as NETMGR.  All the files begin with the
  47. name UUCP, so they are easy to sort out from NETMGR files.
  48.  
  49. Enclosed are the following files:
  50.  
  51.         UUCPCHK.EXE     The main program that does the work.
  52.         UUCPCHK.CFG     A sample config file that must be edited
  53.                         to match your system.
  54.         UUCPCHK.BAD     A sample BAD address file.  Edit it to
  55.                         suit your needs.
  56.         UUCPCHK.DOC     This file you are reading.
  57.         UUCPCHK.LOG     An example of the LOG file.
  58.         UUCPCHK.NAM     An example of the NAM file.
  59.         UPGRADE.TXT     Important Info if Upgrading from an older
  60.                         version.
  61.  
  62. The first thing you should do is edit UUCPCHK.CFG with a text
  63. editor, and make sure you have your name in there, and the path to
  64. your Netmail (.MSG) directory.  I would use the LOG function, at
  65. least at first, to see which messages are flagged as BAD.  The log
  66. can be accumulated until it fills up your hard disk, or you can have
  67. it sent to you as a netmail message using Xrobot or some other
  68. message making program, and then delete the log.  The log is NOT
  69. created unless a BAD message is detected.  The config file is
  70. commented, to assist you in changing it.  Blank lines or lines
  71. preceeded by a semicolon are ignored.
  72.  
  73. The UUCPCHK.BAD file contains bad Internet addresses or segments of
  74. addresses, that are checked against the TO: line in the text of UUCP
  75. messages, and if they match, that message is flagged either with a
  76. HOLD flag or SENT flag (see UUCPCHK.CFG).  Edit this file to suit
  77. your needs.
  78.  
  79. After you run the program and the bad messages are flagged, you can
  80. either check them out manually, or use a program like NETMGR to
  81. check for these flagged messages, and 'bounce' them back to the
  82. sender.
  83.  
  84. UUCPCHK.EXE should be run with either one or two parameters.
  85.  
  86. Examples:
  87.  
  88. UUCPCHK.EXE  D:\FD\NETMGR
  89. UUCPCHK.EXE  D:\RA\FD\UUCPCHK UUCPCFG2.CFG
  90. UUCPCHK.EXE
  91.  
  92. The first parameter is necessary, and it tells the program where the
  93. config file and  bad address file is located, and where to put the log
  94. file.  The second parameter is optional.  The name of the config file
  95. defaults to UUCPCHK.CFG, but you can make it use a config file with
  96. a different name by placing the name as the second parameter.  If
  97. you run the program with NO parameters, you will be shown a help
  98. screen.
  99.  
  100. If you have 2 or more Gateway Names other than UUCP, then you could
  101. run UUCPCHK a number of times, specifying a different CONFIG file
  102. with each invocation of the program.  Each CONFIG file would specify
  103. a different additional Gateway Name.  It runs very quickly, so the
  104. running time should not be a major factor.
  105.  
  106. When entering the paths in the config file or on the command line,
  107. DO NOT put a trailing backslash at the end of the paths.
  108.  
  109. You may optionally create a file called UUCPCHK.NAM which should
  110. contain names, first and last, one full name to a line.  These names
  111. are NOT checked against the UUCPCHK.BAD file for bad internet
  112. addresses.  These are privileged people that you trust not to
  113. subscribe to lists, or whatever you are trying to prevent the others
  114. from doing. This file is NOT necessary to use UUCPCHK.  If it is
  115. present in the UUCPCHK directory (where the Config file is located),
  116. it will automatically be used.
  117.  
  118. The files UUCPCHK.CFG, UUCPCHK.BAD, and UUCPCHK.NAM can have blank
  119. lines and lines starting with a semicolon ';' which will be ignored,
  120. this allows the commenting of the file(s) if necessary.
  121.  
  122. You can have the flagged (as BAD) messages identified, for
  123. processing by NETMGR.  Line 9 in the CONFIG file allows you to have
  124. an error number placed into the Subject line of the message header.
  125. The error will be shown by the following string: #ERR1# to #ERR8#,
  126. and can be searched for by NETMGR to send a customized (for the
  127. particular error) message identifying each type of error.  A list of
  128. the number and types of errors is shown below.
  129.  
  130.   #ERR1# - Error 1: Incorrect Gateway Name
  131.   #ERR2# - Error 2: Disallowed Address in To: line
  132.   #ERR3# - Error 3: Address not on To: line
  133.   #ERR4# - Error 4: Two or more Spaces between To: and Address
  134.   #ERR5# - Error 5: No To: Line
  135.   #ERR6# - Error 6: No @ Symbol in To: line
  136.   #ERR7# - Error 7: Comma in To: line
  137.   #ERR8# - Error 8: No @ Symbol or ! Symbol in To: line
  138.  
  139. I will explain some of the Errors here.  #ERR1# means that a Gateway
  140. name such as 'UUCP [1:135/292.1]' was entered on the To: line of the
  141. message header (I saw this on my BBS).  Only 'UUCP' should have been
  142. entered.  #ERR2# means the To: line in the message Text had an
  143. address that matched a BAD address in the UUCPCHK.BAD file.  This
  144. user may have tried to subscribe to a LIST or FTP a file. #ERR3#
  145. means the To: was present, but did not have an address after it.
  146. #ERR8# will only be shown if you specify in the CONFIG file that the
  147. BANG Symbol '!' will ALSO qualify a message as a GOOD Internet
  148. address.
  149.  
  150. Note: UUCPCHK will always NOT check a message with the HOLD or SENT
  151. flag set, but WILL check a message with #ERR as the first four
  152. characters in the subject line, if you do not have ERROR as the
  153. parameter in Line 9 of the config file.  In other words, if you have
  154. the config file Line 9 set to ERROR to add an error identifier to
  155. the subject line of bad messages, then UUCPCHK looks for #ERR on the
  156. subject line, and if found, will not check the message again.  If
  157. you have NONE for Line 9, then it DOES NOT check the subject line
  158. for the string #ERR.
  159.  
  160. This program does not utilize SHARE, or any kind of file or record
  161. locking in a multitasking environment, so care should be taken to
  162. make sure there are no conflicts with another program editing or
  163. writing a .MSG file at the same time this program is checking your
  164. message base.
  165.  
  166.